home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / trans.arc / TRANS.DOC next >
Text File  |  1984-02-03  |  2KB  |  56 lines
  1. /*  TRANS.C
  2.  
  3.     Copyright (c) 1984, Gordon Lee Waite
  4.                 413 W. Pleasant Street
  5.                 Maquoketa, IA  52060
  6.  
  7.     summary:   trans string1 string2 infile outfile
  8.  
  9.     arguments: string1 contains the target characters which are
  10.            searched for in the text.
  11.  
  12.            string2 contains the characters which will be 
  13.            substituted for their counterparts in string1.
  14.  
  15.            infile is the name of the input file.
  16.  
  17.            outfile is the name of the output file.
  18.  
  19.     options:   none
  20.  
  21.     description:
  22.  
  23.     TRANS processes an ASCII text file, substituting the characters
  24.     in string STRING2 for the characters in string1.  The two
  25.     strings must be of equal length.  The output from this program
  26.     is written to OUTFILE.  The user should not surround the
  27.     two strings with quotes.
  28.  
  29.     NOTE:  This is a character-by-character replacement, not
  30.            a global string replacement.  Every occurance of
  31.            each letter in string1 will change to its counterpart
  32.            in string2!
  33.  
  34.  
  35. example:
  36.      trans /@ sa x1 x2
  37.      This would use x1 for the source file and change all '/' and '@'
  38.      characters to 's' and 'a' respectively.  The resulting text is
  39.      written to x2.
  40.  
  41. note:
  42.  
  43.      REDUCE is applied to both arguments, so you can write unprintable
  44.      characters using '\' as a special marker.  For example, to
  45.      change all tabs to blanks, use the following command:
  46.  
  47.     trans \t \x32 infile outfile
  48.  
  49.      REDUCE understands the following special cases:
  50.  
  51.     \t   TAB
  52.     \n   NEWLINE
  53.     \xHH HEXADECIMAL BYTE
  54.     \0   NULL BYTE
  55. */
  56.